home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / demo / sound / Spoon2_1.lha / DOC / AboutThis.txt next >
Encoding:
Text File  |  1995-03-14  |  14.4 KB  |  412 lines

  1.     ___________/\_____________ ____________/\___________   
  2.    /   __________/________    \      \__      \_______  \     
  3.    \________   \__/     \ ____/        /        /   \    \    
  4.     /      /    \        \/           /        /     \    \
  5.    /      /     /\        \_       __/      __/       \   /
  6.    \___________/  \_______/ \_____/   \____/  \_______/__/
  7.  
  8.          !SPOON - THE GROUPING GROUP OF ALL GROUPS!
  9.  
  10.                      Doc for Sound #2
  11.  
  12. This file contains the text that didn't quite make it into the 
  13. editorial.  This file also reflects the (sorry)  state of mind 
  14. of the coder :)
  15.  
  16. LEGAL DEPARTMENT :
  17.  
  18.  SOUND 2 IS NOT, AND WILL NEVER BE PUBLIC DOMAIN.
  19.  
  20.  SOUND 2 IS  COPYRIGHTED  BUT FREELY  DISTRIBUTABLE  SOFTWARE.
  21.  
  22.               THIS IS ALSO KNOWN AS FREEWARE
  23.  
  24.  YOU  ARE ALLOWED TO SPREAD THE PACKAGE FREELY, AS LONG AS YOU 
  25.  DO NOT CHARGE  MORE THAN  A REASONABLE FEE TO COVER EXPENSES.
  26.  SINCE THIS  IS  HARD TO GRASP  FOR  SOME  DEALERS IN GERMANY,
  27.  I DECLARE THAT NO GERMAN PD DISTRIBUTORS ARE ALLOWED TO CARRY 
  28.  THIS PROGRAM IN THEIR LIBRARIES.
  29.  THE ONLY EXCEPTION ARE :
  30.    
  31.    AMIGA MAGAZIN PD-DISKS, IF THEY SHOULD DESIRE TO DISTRIBUTE 
  32.    THIS.
  33.  
  34.  IT IS ALSO ALLOWED FOR THE FOLLOWING TO PUT SOUND ON CD-ROM :
  35.  
  36.    FRED FISH ON HIS FRESH FISH AND OTHER FISH CD'S
  37.    AMINET ON THE AMINET CD'S
  38.  
  39.  OTHER DISTRIBUTORS MUST CONTACT SPOON FOR A LICENSE.
  40.  
  41.  IT IS EXPRESSIVELY FORBIDDEN FOR THE GERMAN PD LIBRARY :
  42.  
  43.   MALLANDER SOFTWARE
  44.  
  45.  TO DISTRIBUTE SOUND, AND ALL OTHER SPOON RELEASES, AS THEY MOT
  46.  ONLY CHARGE WAY TO MUCH FOR PD STUFF, BUT ALSO SELL VARIOUS
  47.  SCENE RELEASES FOR HIGH PROFITS AND SELL DISKS WITH RIPPED GFX
  48.  
  49.  REMEMBER,  THAT  THE  COPYRIGHT  FOR  SOUND  LIES  WITH  JOHN 
  50.  'SHAYERA' HINGE AND CHRISTINE  HANSEN (CHRISTINE DE LA QUEEN) 
  51.  OF THE DEMO GROUP SPOON,BUT THE COPYRIGHT FOR THE MUSIC, LIES 
  52.  WITH THE INDIVIDUAL MUSICIANS THEMSELVES.  
  53.  THEREFOR,  IF  YOU  LIKE  THE MUSIC, AND WOULD LIKE TO USE IT 
  54.  OTHER  THAN FOR  PRIVATE LISTENING, THEN  CONTACT US, AND  WE 
  55.  WILL PUT YOU IN TOUCH WITH THE AUTHOR, AND  USUALLY HE OR SHE 
  56.  WILL ALLOW YOUR USE OF THE MUSIC.
  57.  
  58.  
  59.  The People responsible for Sound #2 are :
  60.  
  61.  Christine Hansen (CDLQ) :
  62.    Concept, Design and Graphics
  63.  
  64.  Carsten Kaae (AXE) :
  65.    Graphics
  66.  
  67.  Subsonic / Disaster :
  68.    Font stuff
  69.  
  70.  Braintumor & Heywood / Stone Arts :
  71.    Main tune
  72.  
  73.  John Hinge (SHAYERA) :
  74.    Code and the small chars in the font (really bad eh. :)
  75.  
  76.  Intro :
  77.   Slide / Polka Brothers :
  78.    Code, Graphics, Music
  79.   Shayera / Spoon :
  80.    Startup code, and some minor details
  81.  
  82.  For the individual musicians, see the Info screen in Sound 2.
  83.  
  84.  
  85. History so far :
  86.  
  87. The original code for Sound #1, has almost NOT been reused for 
  88. this program for several reasons :
  89. The original code  was a superb  example  of how NOT to code a 
  90. program intended for easy maintaining..
  91. The  source consisted of two main parts and a host of support-
  92. files,  which  not  even I could remember quite which did what 
  93. and why :)
  94. Also  the  code was very bad, and resembled nothing as much as 
  95. the fact that it was written in great haste...
  96. The  goal for the Sound 2  Source, is to achieve as much modu-
  97. larity  as possible, thereby making migration of the code pos-
  98. sible.  This could be used to port it to run on GFX-Cards,  or 
  99. even  a Port to  other machines  (PC's, PowerPC's, HP-Apollo's 
  100. etc...)  I  would only have  to update for  example GFXSupport 
  101. (and the replayer if I port to a new machine)
  102.  
  103.  
  104. This  program has  been written entirely in 'C' except for the 
  105. following :
  106.        The Decruncher (RNC V2)
  107.        The Replayer (The Player V6.1A)
  108.  
  109. The source for Sound 2 is divided into these modules :
  110.  Main.c :
  111.                 Opens global stuff, calls GFX routines, etc...
  112.                 Portable to any C-compiler (& therefor compu-
  113.                 ter :) )
  114.                 There is some native (Amiga-OS) stuff in this, 
  115.                 but this will be  fairly  easy to port (I hope
  116.                 /suspect :)
  117.  
  118.  GFXSupport.c :
  119.                 Implementation specific graphics routines..
  120.                 Currently 1 version :
  121.                  One for Native AGA Amiga's
  122.                  This allocates screens, loads, and  decrunches 
  123.                  screen data, and handles gadgets etc..
  124.  
  125.  FileSupport.c : 
  126.                 Implementation  of  General  File Loading rou-
  127.                 tines...
  128.  
  129.  IntroSequence.c :
  130.                 This run the  Spoon  intro sequence, ie. shows 
  131.                 some nice pictures.
  132.  
  133.  OnBoardGFX.c :
  134.                 This contains the 'onboard' graphics, gadgets 
  135.                 and stuff, which is too small to deserve sepa-
  136.                 rate loading..
  137.  
  138.  Texts.c :
  139.                 This  contains  ModuleInfo's, Rules text,  and 
  140.                 the dreaded Editorial...
  141.                 I don't  change this  so often, so it's better 
  142.                 to leave it  in a separate file, and save com-
  143.                 pilation time..
  144.  
  145.  P61.o :
  146.                 This is a version of The Player V6.1 by Guru / 
  147.                 Sahara Surfers adapted to work with C programs 
  148.                 (Parameter calls etc..)
  149.  
  150.  RNC_2.o :
  151.                 This  is  a Decruncher  for the ProPack 2.x by 
  152.                 Rob Northen. This decrunches 'mode 2' crunched 
  153.                 files.
  154.  
  155.  Due to  the way I am  organizing  things the  Main program is 
  156.  quite small.  The Final Compile gives ca. 57 Kb. Compare this 
  157.  with 'EuroChart's 4-500 Kb (unpacked) Modularity Rulez :)
  158.  
  159.  as of 14.02.95 nearly all the code is up and running...
  160.  It shows the texts correctlym and the Loader's are working...
  161.  now it is a matter of  banging on the selectors visually, and 
  162.  tackle the dreaded Intro-Sequence.. and  ofcourse waiting for 
  163.  the Intro..
  164.  
  165.  as of 17.02.95  all the code is finished,  and  it appears to 
  166.  work :)  Especially the selector gadgets were  quite funny to 
  167.  set up...
  168.  Sometimes Intuition can be a real pain...  If you  use struct 
  169.  Image stuff, it  destroys the data  in all  6 bitplanes, even 
  170.  though the image is only 5 planes deep.  Therefor  I  decided 
  171.  to use struct Borders instead..
  172.  Why is the autodocs for intuition so strange ??
  173.  The documentation says the  Border uses  a sequence of vector 
  174.  coordinates, but it is really  just plain coordinates !!!  It 
  175.  looked very funny until I caught this little bug :)
  176.  
  177.  as of 24.02.95  I am getting REAL tired of this production..
  178.  all code is running, and everything appears to be ok.
  179.  I have gotten all the GFX inseted at its place, including
  180.  some GFX I only found out I needed, when i looked through the
  181.  data directory in order to clean out not needed files..
  182.  Now there is pretty images for both sets of selectors :)
  183.  
  184.  The most of the time between 25.02 & 2.03 has been spent both
  185.  waiting for the Intro, and bugfixing some stuff...
  186.  The only real significant changes are :
  187.  Sound now works form Startup-Sequence (as it should)
  188.  You can Pause and Exit the Editorial
  189.  
  190.  For more insight into the progress of how I made this, read
  191.  the text file called Sound2.LOG, it is sort of a day to day
  192.  diary of what happened when..
  193.  
  194.  Small Instructions :
  195.  
  196.  In the CLI type Sound2 <return>
  197.  
  198.  When tired of it, either press ESCAPE or click on the 
  199.   'exit to DOS' gadget
  200.  
  201.  Press the keys 1-\ on the keyboard(above the alphabetic keys)
  202.  to load the 13 selectable tunes !!
  203.  Due to policies, you can NOT reselect the wonderful first mo-
  204.  dule, as this module is larger than the rest of  the modules, 
  205.  and is a special introduction piece.  This is  NEVER meant to 
  206.  be re-selectable... listen, push gadget and weep :)
  207.  
  208.  Simple, eh... ??
  209.  
  210.  Amongst  the response to Sound #1, several  people  (swappers 
  211.  mostly) have complained  that  Sound wasn't a 'one file' pro-
  212.  gram, but that would be a real pain in the ***!!!
  213.  I would have to make it either with overlays, since it  isn't 
  214.  feasible to load ALL of the stuff (300Kb gfx & 500 Kb msx) at 
  215.  once  AND leave space for  buffers,  spare screens etc... and 
  216.  frankly, I know zilch about overlays..
  217.  Or make it as 2 files..
  218.  A main program and one large datafile, like  some diskmags do 
  219.  it...  I have thought about this, but I find it  much  easier 
  220.  to do it with my current system of separate files...
  221.  
  222.  Sound #2 is developed on the following configuration :
  223.  
  224.   Commodore Amiga A1200, 2Mb Chip memory, AGA chipset
  225.   Kickstart V 3.0 (39.106)
  226.   Workbench V 3.0 (39.29)
  227.   X-tra diskdrive,of suspect manufacturing:) (6 years/no err's)
  228.   Quantum Prodrive ELP120 120 Mb 3½" HD
  229.  
  230.  Tested on :
  231.   A1200, No FastRam, Kick 3
  232.   A1200, 4 Mb FastRam, Kick 3 (Thanx Merge)
  233.   A4030, 2 Mb Chip, 2 Mb Fast, Kick 3 (Thanx Bagger)
  234.  
  235.  
  236.  Tools used in the creation of Sound #2 so far :
  237.  
  238.  SAS/C Amiga C/C++ compiler V6.50
  239.   (I hope SAS Institure reconsiders their dropping the Amiga..
  240.    it will be irritating to port this to eg. Maxon C/C++ 3)
  241.  
  242.  Cygnussoft CED 3.5
  243.   (Miles beyond SAS/C's SE editor :)
  244.  
  245.  HiSoft Devpac Amiga Assembler V3.04
  246.   (The best for serious system programming)
  247.  ASM-One V1.25 by The Flame Arrows
  248.   (GURU/S2 : Why did you drop the Devpac versions of P61 ???)
  249.  
  250.  Electronic Arts Deluxe Paint V4.5 (AGA)
  251.   (It's old, It's slow, but it is trustworthy :)
  252.  
  253.  Cloanto's Personal Paint V6
  254.   (Why can't DPaint use Sound's legal system font ??)
  255.  
  256.  PicCon V2.5 (Registered Version :)
  257.   (This program is REALLY great, go out and register it today)
  258.  
  259.  ExoticRipper V2.27 (Registered)
  260.  
  261.  ProPack 2.08 by Rob Northen Computing
  262.   (This cruncher gives really great performance !!
  263.    the raw GFX data for sound takes up 1740800 bytes
  264.    the crunched gfx takes               302202 bytes
  265.    that is a crunch to only 17.36 % !!!)
  266.  
  267.  The Player V6.1A (610.1) -  08.01.95 by Guru / Sahara Surfers
  268.   (The best for both speedy replay, and good diskspace saving)
  269.  
  270.  Directory Opus V4.12 by Innovatronics
  271.   (nice.. still waiting for V5)
  272.  
  273.  DiskMaster V2.1c by Greg Cunningham / Progressive Peripherals 
  274.  Inc.
  275.   (not so advanced but uses MUCH less memory than DOpus)
  276.  
  277.  AmigaDate by Tomi Ollila <too@cardhu.cs.hut.fi>
  278.   (one of those tools you wonder how you got by without)
  279.  
  280.  Special Hardware used :
  281.  
  282.  Commodore Amiga CD32+FMV,
  283.   to keep my mind distracted while I work :)
  284.  
  285.  Special thanks so far :
  286.  
  287.  Estrup / Static Bytes for input on how to 'cheat' Intuition..
  288.   Actually the idea is NOT to cheat Intui.. For 12 revisions I 
  289.   was  using an  interlieved  bitmap, and this has given me NO 
  290.   end of headaches as blitting into this,and extending it with 
  291.   an extra bitplane for text etc, was NOT so easy.
  292.   Estrup  claimed, that it wasn't neccessary  to use an inter-
  293.   lieved screen, and he was right:)(I don't know why it didn't 
  294.   work before ??)
  295.  
  296.  Merge / Polka B.    for being friendly
  297.  
  298.  Airwalk / Polka B.  for keeping me writing in C :)  (You keep 
  299.   bugging me to write it in ASM, so  I  keep  bugging you  and
  300.   keep  on  doing it in C ;^)  Thanx for the wipe 'algorithm', 
  301.   but as of 14.02, I got some response on my current wipes, so 
  302.   it  will probably  not be implemented...  except  maybe  for 
  303.   Sound #3, when I have rewritten it in C :)
  304.  
  305.  Colin    Some day I WILL do a GFX card version,in the meantime, 
  306.   I am REALLY  enjoying that CD32... Now  I just have to get a 
  307.   SX-1 :)
  308.  
  309.  Slide / Polka B. Well the music for my 40K was nice atleast:)
  310.   Thanks for lending me the batch of CD's...  Now I have some-
  311.   thing to listen to :)
  312.  
  313.  Bagger  For letting me run this on a 4030,and for coming with 
  314.   good suggestions  concerning code, even though  I seldom use 
  315.   them :) (I don't know  if the 'hack'  from Viacom is necces-
  316.   sary ??) (actually i KNOW the 'hack' form Viacom is not nec-
  317.   cessary :)
  318.  
  319.  The AD&D 2nd. Ed. Crowd,  for taking my mind of off things at
  320.   least once in the week...
  321.  
  322.  Guru / Sahara Surfers for keeping on updating The Player, and 
  323.   making it more powerful with each revision...
  324.  
  325.  To these for keeping me 'sane' :
  326.  
  327.  J.M.Jarre        : Concerts in China, Equinoxe, Oxygene
  328.  Queen            : A Day At The Races, The Game,News of 
  329.                     the world, Innuendo, Greatest Hits I+II
  330.  Erasure          : Wonderland,The Circus,The Innocents, 
  331.                     Wild!, Chorus, I Say I Say I Say
  332.  Bjørn Lynne      : Montage
  333.  Pet Shop Boys    : Very
  334.  Mike Oldfield    : Tubular Bells II
  335.  Grid             : Evolver
  336.  Ace of Base      : Happy Nation, US-Version
  337.  ABBA             : Gold (Ok, so I'm nostalgic. just bugger off)
  338.  Kim Wilde        : The Singles Collection
  339.  The Commitments  : Soundtrack
  340.  
  341.  
  342.  Look out for other forthcoming Spoon productions :
  343.  
  344.   Blue Savannah : 
  345.         A Harddisk only, Music-Experience-Demo
  346.         Code by : Shayera, GFX by : CDLQ,AXE, SFX by : B-Toven 
  347.         (after Erasure)
  348.         This demo will be an AGA  and  Harddisk  only,  as the 
  349.         amount of data is too great to be  practical on floppy 
  350.         disk, and besides; HD's are cheap,  so  let's all sup-
  351.         port them, and then we can make as nice demo's  as the 
  352.         PC's !!!
  353.  
  354.  If you are interested in joining Spoon (and you should be !!)
  355.  Then  send us some examples of your work.. Coders should con-
  356.  tact me (Shayera)  All  others contact  Christine de La Queen 
  357.  (adress elsewhere on this disk)
  358.  
  359.  We are searching for :
  360.         Coders (AGA experience preferred)
  361.         SFX    (Protracker, or PT compatible (Fast/Take/Scream 
  362.                etc.. 4 channels .MOD)
  363.         GFX    (A 'full screen' painter would be nice)
  364.         Trace  (NOT just another  'look  at them glassballs on 
  365.                that chessplane')
  366.  
  367.  We`ll put up people from Saudi Arabia or Kuwait are very wel-
  368.  come, and can contact us concerning our special economic sup-
  369.  port member program (ESMP)  (We promise nice long letters and 
  370.  cheap membership :) (ok, just kidding, but don't hold back if 
  371.  you want to support us ;)
  372.  
  373.  
  374.  Questions, bug reports etc, to :
  375.  
  376.   John 'SHAYERA' Hinge of SPOON
  377.  
  378.   Silkeborgvej 220 B, 1
  379.  
  380.   DK-8230 Åbyhøj
  381.  
  382.   Denmark
  383.  
  384.  email : nomachine-nowhere-noplace@thevoid.gov
  385.  www   : don't hold your breath :)
  386.  
  387.  actually you can reach Spoon via FidoNet :
  388.   Duffy/Spoon :
  389.    Rikard Bosnjakovic @ 2:203/316.100
  390.  
  391.  Make  a note of which  Spoonie the  message is for, and Duffy 
  392.  will forward the message (he better... ;)
  393.  
  394.  
  395.  Advert :
  396.  
  397.      If you are an official representative from a game company 
  398.  seeking  new employees, then I can be contacted  at the above 
  399.  address... I am fluent in 68K Assembler, and 'C', and,as this 
  400.  program shows,I am not afraid of working in big projects with 
  401.  modular builds.  This  has  been a good excercise in managing 
  402.  such a project,and I feel pretty confident about my abilities 
  403.  when it comes to coding on the Commodore Amiga series of mini 
  404.  computers.  I  have  also  some  experience  in   coding  the 
  405.  Commodore  64, but this is probably  not  of any significance 
  406.  here in 1995 :)
  407.  
  408.  
  409.   1995, the revolution is coming... 
  410.   Spoon... We always eat our cornflakes
  411.  
  412.